(This is a section on QUEUE which is switched out of RUTGERS/UCI LISP
and hence was removed from the manual.)


      Queueing Files

      (QUEUE QNAM:  DEV:  FILNAM  SWITCHES  DEV:  FILNAM SWITCHES
              ....)

              QUEUE  is   an  FSUBR  that  queues  files  to  the
              specified device or  queue.   It is essentially the
              same as  the monitor command  QUEUE, both in syntax
              and effect.   The main  use of this  function is to
              get output  to  line  printer,  paper tape punches,
              etc.    However,   the  input  queue  can  also  be
              specified in order to batch a job.

              A  queue  name QNAM:  is  an  atom  of three to six
              letters whose  last letter is a  colon.   The first
              three  letters  indicate  the  general  queue  (see
              below)  and  the  following  letters  indicate  the
              specific queue.


              LPT     =LINE PRINTER QUEUE
              PTP     =PAPER TAPE PUNCH QUEUE
              PLT     =PLOTTER QUEUE
              CDP     =CARD PUNCH QUEUE
              INP     =JOB BATCH QUEUE

              Thus  (QUEUE LPT:  ...)  would  queue  to  the line
              printer without specifying a  specific line printer
              queue.   (QUEUE  LPT0:  ...)  would  queue  to line
              printer 0.  As in the monitor command, if the queue
              name QNAM:  is not  specified,  the  default  is to
              LPT:.


              If an  INPUT  queue is specified,  a maximum of two
              files is permitted.   The second file  is  taken as
              the  name of the log file.  If it is not specified,
              the filename of the first file with an extension of
              .LOG is assumed.













                               4 . 1 . 7




              Switches  consist of two element  lists,  the first
              element being the switch and the second  the value.
              In the case of a required non-numeric value  (as in
              DISP)  only the first three letters of the argument
              are looked at i.e. PRESERVE and PRE are equivalent.

              SWITCH ARGUMENT     EXPLANATION         QUEUES ALLOWED


              COPIES NUMERIC      NUMBER OF COPIES    LPT,PTP,CDP,PLT
                                  TO BE OUTPUT
              FORM   NON-NUMERIC  FORMS FOR DEVICE    LPT,PTP,CDP,PLT
              LIMIT  NUMERIC      OUTPUT LIMIT        LPT,PTP,CDP,PLT
              DISP   'PRE'        PRESERVE FILE       ALL
                     'REN'        RENAME FILE OUT OF
                                  DIRECTORY AND DELETE
                                  AFTER SPOOLING      ALL
                     'DEL'        DELETE AFTER SPOOLING ALL
              CPU    NUMERIC      MAXIMUM CPU SECS FOR JOB INP ONLY

              Defaults  are system defined except  for DISP which
              defaults to PRE so that all files are preserved.

              As in the monitor command,  switches are  in effect
              until superseded by another instance of the switch.
              Switches may precede the first file or device.


              DEV's are either an atom whose last character  is a
              colon or a  ppn  specification.   A  device affects
              only the  files following it.   It is superseded by
              another device.  If no device is specified, DSK: is
              assumed.



















                               4 . 1 . 8




      Examples:

              *(QUEUE LPT: DSK: FOO (FOO .  LSP))

              Prints  the  files  FOO  and  FOO.LSP  on  the line
              printer.

              *(QUEUE LPT: (FOO .  LSP)(COPIES 2))

              Prints two copies of FOO.LSP on the line printer.

              *(QUEUE INP: (FOO .  CTL))

              Queues  a  job using FOO.CTL as  its  command file,
              leaving a LOG file in FOO.LOG.

              *(QUEUE INP: (FOO .  CTL)(FOO .  LOG))

              Same as above.

































                               4 . 1 . 9




      Recovery From QMANGR Errors

      The QUEUE function must swap the LISP high segment  for the
      QMANGR  high segment.   It then  transfers  control  to the
      QMANGR high segment.   In most  cases,  if  QMANGR finds an
      error,  it simply prints an error message.  In a few cases,
      however,  it  returns  control  to  the  monitor.   The REE
      command  will  restore  the  appropriate  high  segment and
      processing will continue.   Note that in this instance, the
      system does not wait for control characters.

      A  .START  command to  the  monitor  will  also restore the
      user's high segment.   However,  this is not recommended as
      the reallocation procedure will be entered.






































                               4 . 1 . 10